Метод IDataset::Append

Добавляет запись в набор данных.

IDL

[id(103431)]
HRESULT Append(
    [out, retval] VARIANT_BOOL* Value
);

Параметры	Описание
Value	Возвращаемое значение

"True", если добавление записи в набор данных выполнено успешно.

Выполняет добавление записи по следующему алгоритму:

№	Описание
1.	Если набор данных не находится в состоянии добавления записи (значение свойства IDataset::State не равно "dstInsert"), и у текущего пользователя есть права на добавление записи (значение свойства IDataset::CanInsert равно "True"), то вызывает событие IDatasetEvents::OnDatasetBeforeAppend. Иначе метод завершает работу.
2.	Если в событии IDatasetEvents::OnDatasetBeforeAppend добавление записи не было отменено, то метод вызывает событие IDatasetEvents::OnDatasetBeforePositionChange. Иначе метод завершает работу.
3.	Создает пустую запись, устанавливает ее текущей и переводит набор данных в состояние добавления записи (свойству IDataset::State устанавливает значение "dstInsert").
4.	Вызывает событие IDatasetEvents::OnDatasetAfterAppend.
5.	Вызывает событие IDatasetEvents::OnDatasetAfterPositionChange.
6.	Возвращает "True", если добавление записи в набор данных выполнено успешно. Иначе возвращает "False".